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REMARKS 



Applicant respectfully requests reconsideration and allowance of the application and 
all pending claims in view of the above- amendments and the following remarks. 
I. SPECIFICATION 

A. Title 

The title of the invention was objected to as being not descriptive. 

With this Amendment, the title is amended to include further limitations from claim 1 
and is now sufficiently descriptive. 

If the objection to the title is maintained, Applicant respectfully requests a more 
detailed explanation as to how the title is not descriptive or a suggestion as how the title can 
be further improved. 

B. Abstract 

Applicants enclose a "replacement" abstract in which the legal phraseology has been 
removed, as suggested in the Office Action. 

C. Specification Section Headings 

The specification was objected to as not following the sections identified in 37 C.F.R. 
§ 1.77(b) in order. 

The section headings listed in § 1.77(b) are suggested, but not required. In any case, 
the Preliminary Amendment filed with the application added all relevant sections and in the 
order specified in § 1.77(b). Further, additional section headings are added with the present 
amendment. 

Finally, Applicant submits a substitute specification in which the appropriate section 
headings can be seen more clearly. 

Applicants respectfully request that the specification be replaced with the enclosed, 
clean "substitute specification". No new matter has been added. Applicants also enclose an 
annotated version that illustrates the marked changes from the immediate prior version, as 
amended with the Preliminary Amendment filed December 15, 2005. 

With these amendments, Applicants request that the objections to the specification be 
withdrawn. 
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H. DOUBLE PATENTING 

Claims 1, 3-6, 8-10, 13-17, 19-22 are rejected on the ground of nons-tatutory 
obviousness-type double patenting as being allegedly unpatentable over claims 1, 2, 4-10, 
147, 15, 17, 19, 20-23 of copending Application No. 10/561,114. 

Enclosed is a terminal disclaimer, which overcomes the provisional rejection based on 
non- statutory double patenting. 

m. Claim Rejections Under 35 U.S.C. §103 

Claims 1, 3-22 are rejected under 35 U.S.C. 103(a) as being allegedly unpatentable 
over Andy Stanford-Clark, Integrating Monitoring and Telemetry Devices as Part of 
Enterprise Information Resources , Websphere MQ Development, IBM software Group, pp. 
1-13 (March 2002) (hereinafter "IBM Document"), in view of Petite, U.S. Patent No. 
7,103,511. 

A. IBM document 

1.1 Summary of the document 

The IBM document concerns a general protocol for an MQ Integrator SCADA device 
(usually named MQIsdp) developed by the IBM Software Group. It deals with notions of 
"publish" and "subscribe", and illustrates some examples of application. 

1.2 Relevance of the Document 

In accordance with the Examiner's opinion, the IBM document discloses (using the 

terms of claim 1): 

System for remote control of equipment (« a system that manages the flow of 
information from remote devices to any enterprise applications that need the data », 
p. 3, 1.1-3, « telemetry integration applications », p. 9, 1.8) enabling interconnection 
between at least one server ( « broker » ) and at least one remote equipment ( « client » ) 
using the MQIsdp protocol ( « this allows remote devices to connect to the broker 
using the MQIsdp protocol », p.9, 1.2-3), said system associating, with at least one of 
the said remote equipment, radiocommunication means (« the devices communicate 
with the Arcom Director unit using 20-mile line-of-sight, spread-spectrum wireless 
links from Data-Line Goup », p. 12, 1.3-4, « communicating through Very Small 
Aperture Terminal (VSAT) satellite links », p. 13, 1.3) 

1.2.1 Differences of the Document Relative to Claim 1 

Regarding claim 1, and contrary to the Examiner's opinion, the IBM document does 
not disclose: 
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radiocommunication means capable of sending and receiving AT type commands sent 
by and / or to be sent to an external application used by the said remote equipment; 
radiocommunication means endowed with a set of special AT commands for 
exchanging data with at least one server using the said MQIsdp protocol, so as to 
enable an interconnection between the said server(s) and the said remote equipment 
through the said radiocommunication means, without requiring knowledge of the said 
MQIsdp protocol in the said remote equipment; 

at least a first mode, radiocommunication means only managing signaling of a data 
exchange, the said data being transferred directly from remote equipment to a server, 
or vice versa. 

Contrary to the Examiner's opinion, the notion of AT commands is not at all 
suggested in the IBM document. Moreover, there is nothing in the IBM document that 
discloses or suggests the using of a set of specific AT commands, enabling an external 
application to manage the data exchanges between a remote terminal and a broker without the 
external application knowing the MQIsdp protocol. 

As a consequence and contrary to the Examiner's opinion, the IBM document is not 
relevant toward the invention as defined by independent claim 1 of the present patent 
application. 

B. PETITE document (U.S. Pat. No.7 103 511 B2) 

2.1 Summary of the document 

The PETITE document deals with wireless communications networks for remote 

controlling and monitoring wireless devices. More particularly, this document concerns an 

automatic control system for controlling remote equipment implemented via a host computer 

which is connected to a wide area network 120 (WAN) and comprising a plurality of wireless 

transceiver devices 125. Each transceiver device 125 has a unique identifier and means of: 

receiving a sensor data signal from one of remote devices; 
transmitting an original data message using a predefined wireless 
communication protocol comprising the corresponding unique identifier of 
device 125 and sensor data signal. 

One of the plurality of transceiver devices 125 is in charge of sending the whole 
original data messages to a site controller 150, connected to the WAN 120, which is 
configured to manage communications between wireless communications networks (remote 
equipment) and the host computer connected to the WAN 120. 



2.2 
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Even though the PETITE document relates to a system for monitoring and/or 

controlling a plurality of remote devices, there is nothing in PETITE that discloses or 

suggests features of claim 1, namely (using the terms of claim 1): 

the fact that the system for remote control of apparatuses enables the 
interconnection between at least one broker and at least one remote apparatus 
according to the MQIsdp protocol; 

the fact that the system associates radiocommunication means capable of 
internally processing a communication protocol implementing API-type source 
functions available in a software platform (Open AT) enabling at least one 
application to be embedded ; 

the fact that said radiocommunication means are provided with a set of specific 
(API) functions enabling data to be exchanged with at least one server 
implementing said MQIsdp protocol, so as to enable an interconnection 
between said broker(s) and said remote apparatus(es) via said 
radiocommunication means, with the latter also managing at least one 
application between said broker(s) and said remote apparatus(es). 
the fact that, at least a first mode, said radiocommunication means only 
managing signaling of a data exchange, the said data being transferred directly 
from remote equipment to a server, or vice versa. 
As a consequence, the PETITE document is not relevant toward the invention as 

defined by independent claim 1 of the present patent application. 

C. Non-relevance of the combination of the IBM and PETITE documents 

Neither the IBM document nor the PETITE document is relevant towards the invention 
as claimed by independent claim 1. 

With neither the IBM document nor the PETITE document providing the features of 
claim 1, the combination of the PETITE and IBM documents does not disclose or suggest the 
features of the present invention as recited in independent claim 1 . 

As a consequence, the invention recited in claim 1 in dependent claims 3-18 (at least 
because these claims depend from claim 1) would not have been obvious to a person of 
ordinary skill in the art at the time the invention was made. 

IV. SUMMARY 

The foregoing remarks are intended to assist the Office in examining the application 
and in the course of explanation may employ shortened or more specific or variant 
descriptions of some of the claim language. Such descriptions are not intended to limit the 
scope of the claims; the actual claim language should be considered in each case. 
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Furthermore, the remarks are not to be considered exhaustive of the facets of the invention 
which are rendered patentable, being only examples of certain advantageous features and 
differences, which Applicants' attorney chooses to mention at this time. For the foregoing 
reasons, Applicants reserve the right to submit additional evidence showing the distinction 
between Applicants' invention to be unobvious in view of the prior art. 

Furthermore, in commenting on the references and in order to facilitate a better 
understanding of the differences that are expressed in the claims, certain details of distinction 
between the same and the present invention have been mentioned, even though such 
differences do not appear in all of the claims. It is not intended by mentioning any such 
unclaimed distinctions to create any implied limitations in the claims. 

The Director is authorized to charge any fee deficiency required by this paper or 
credit any overpayment to Deposit Account No. 23-1 123. 

Respectfully submitted, 

WESTMAN, CHAMPLIN & KELLY, P.A. 



By: /David D. Brush/ 

David D. Brush, Reg. No. 34,557 
900 Second Avenue South, Suite 1400 
Minneapolis, Minnesota 55402-3319 
Phone: (612) 334-3222 Fax: (612) 334-3312 
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SUBSTITUTE SPECIFICATION 
(ANNOTED TO SHOW MARKED CHANGES) 

SYSTEM AND METHOD FOR REMOTE CONTROLLING OF EQUIPMENT 
ENABLING INTERCONNECTION BETWEEN A SERVER AND REMOTE 
EQUIPMENT IN ACORDANCE WITH THE MQIsdp PROTOCOL WITH THE AID 
OF AT COMMANDS , AND CORRESPONDING DEVICE, 
RADIOCOMMUNICATION MODULE, AND SET OF COMMANDS 

CROSS-REFERENCE TO RELATED APPLICATION 
5 This Application is a Section 371 National Stage Application of International 

Application No. PCT/FR2004/001499, filed June 16, 2004 and published as WO 
2004/114625 A2 on December 29, 2004, not in English. 

STATEMENT REGARDING FEDERALLY SPONSORED RESEARCH OR 
DEVELOPMENT 

10 None. 

THE NAMES OF PARTIES TO A JOINT RESEARCH AGREEMENT 
None. 

FIELD OF THE DISCLOSURE 
The domain of the disclosure is remote control of equipment, and particularly 
equipment with limited data processing resources. Thus, the disclosure is applicable for 
15 example to remote data recording systems, for example on water, gas or electricity 
meters, and more generally to telemetry, order monitoring and more generally Machine 
to Machine (M to M) systems. 

BACKGROUND OF THE DISCLOSURE 
Many solutions already exist for performing such operations. They have 
2 0 generally been developed specifically for a given application. In other words, they are 
"proprietary" solutions that are difficult to adapt to other applications. 
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There is also a protocol developed by the IBM and ARCOM Control Systems 
companies (registered trademarks), known as the "MQIsdp Messaging" technology. This 
technique proposes a communication protocol between one or several items of 
equipment with limited resources, and one or several servers, using a TCP/IP link. 
5 However, even with this specific protocol, special processing means 

(microprocessors, memories, etc.) have to be added to the equipment so as to set up a 
dialog with these remote servers, depending on the required MQIsdp format. The 
connection between the equipment and the server may use a telephone type link using a 
modem. 

10 However, in many applications, it would be desirable to be able to manage 

without a wire telephone link. In this case, radiocommunication means could be 

envisaged, for example according to the GSM or GPRS standard. 

In this case, radiotelephone equipment would be used to perform the modem 

function. However, according to prior art, it is necessary to associate special and 
15 proprietary data processing means with the equipment to set up and exchange data with 

the server. 

This aspect is a very important limitation to the development of the applications 
mentioned above, and to many other applications with which the MQIsdp protocol could 
be used. 

2 0 SUMMARY 

One particular aspect of an embodiment of the invention is to overcome this 
disadvantage with prior art. 

It should be noted that the fact that this problem has been identified is itself part 
of an embodiment of the invention. At least some of those skilled in the art are 
2 5 convinced that it is absolutely necessary to equip terminal equipment with sufficient 
processing means, and will never consider reducing or eliminating these processing 
means. 



W5 1.1 2-0024 

-3- 

However, one aspect of an embodiment of the invention is to simplify the 
processing in the equipment, and to avoid the need for this equipment to have complex 
and expensive means such as a microprocessor. 

Another aspect of an embodiment the invention is to propose a simple and 
5 generic technique to easily and efficiently set up a dialog with a server using the 
MQIsdp protocol. 

Yet another aspect of an embodiment of the invention is to provide such a 

technique for setting up a connection between servers and equipment by radiotelephone 

link in a simple, standardised and inexpensive manner. 
1 0 Another aspect of an embodiment of the invention is to provide such a technique 

to develop a large number of applications, without it being necessary to develop specific 

applications each time. 

Another aspect of an embodiment of the invention is to provide such a technique 

in which there is no need to know the MQIsdp protocol in the developed applications. 
15 Yet another aspect of an embodiment of the invention is to provide such a 

technique that is technically simple and upgradeable and adaptable to various situations 

(for example the amount of data to be exchanged) and to any future changes that are 

made. 

These aspects and others that will appear more clearly in the following, are 
2 0 achieved using a system for remote control of equipment enabling interconnection 
between at least one broker and at least one remote equipment using the MQIsdp 
protocol. 

According to an embodiment of the invention, radiocommunication means 
capable of sending and receiving AT type commands sent by and / or sent to an external 
2 5 application used by the said remote equipment are associated with at least one of the said 
remote equipment, the said radiocommunication means being provided with a set of 
special AT commands for exchanging data with at least one broker using the said 
MQIsdp protocol, so as to enable an interconnection between the said server(s) and the 
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said remote equipment through the said radiocommunication means, without requiring 
knowledge of the said MQIsdp protocol in the said remote equipment. 

Thus, it is easy and simple to manage data exchanges without the need to develop 
special applications or to associate important means (particularly microprocessor and 
5 memory) with a terminal. Neither the terminal nor the application needs to know the 
MQIsdp protocol. The radiocommunication means manage these aspects. The 
application only needs to know the new AT commands. 

Advantageously, at least in a first mode, the said radiocommunication means 
only manage signalling of a data exchange, the said data being transferred directly from 
1 0 remote equipment to a server, or vice versa. 

Preferably, at least in a second mode, the said radiocommunication means 
manage signalling of a data exchange and transfer of the said data, the data being 
temporarily stored in at least one buffer memory. 

In this case, the size of the said buffer memory(ies) can advantageously be 
1 5 parameterable. 

According to one advantageous embodiment, the said system operates in the said 
first mode when the size of the said buffer memory(ies) is equal to 0, and otherwise in 
the said second mode. 

Thus, a simple and efficient means is obtained for performing two functions 
2 0 (mode selection and queue sizing) with a single command. 

In one advantageous embodiment of the invention, the said radiocommunication 
means comprise a radiocommunication module comprising all radio frequency and base 
band processing means on the same substrate, together with means of managing the said 
AT commands. 

2 5 In particular, the said radiocommunication means can include the said MQIsdp 

protocol in the form of an "open-AT" application defining the said set of special AT 
commands. 

Advantageously, the said set of special AT commands includes commands for: 
- connecting to one of the said servers; 
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- sending messages; 

- receiving messages. 

Preferably, at least some of the said special AT commands are organized so as to 
be able to perform at least two functions and / or to act on at least two distinct aspects, as 
5 a function of a predefined configuration. 

This can strongly reduce the number of necessary commands, while performing 
all necessary operations taking account of any future developments. 

Thus in one preferred embodiment, the said set of commands only includes 8 
commands. 

10 The said set of special AT commands advantageously includes at least one 

configuration command used to define communication parameters with one of the said 
servers. 

Preferably, the system uses a single configuration command (+WSPGSET) for 
configuration of radiocommunication aspects and the general configuration of aspects 
1 5 related to the MQIsdp protocol. 

In particular, the said configuration command can be used to select one of at least 
two transmission modes (GSM or GPRS). 

Advantageously, the system uses three configuration commands: 

- a general communication configuration command (+WSPGSET); 

2 0 - a connection configuration command (+WSPCSET), particularly used to 

specify the coordinates of a server; 

- a configuration command for the "will" configuration message (+WSPWMS), 

particularly to specify the channel to which a message will be sent. 
Preferably, it also uses at least one general communication command for sending 
2 5 and / or receiving messages using the MQIsdp protocol. 

Thus, five general communication commands can advantageously be used: 

- a command for specifying an MQIsdp context (+WSPDCONT); 

- a command for managing a connection with a server (+WSPCONM); 

- a command for sending a message (+WSPSMSG); 
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- a command for receiving a message (+WSPRMSG); 

- an administration command, used to do a reset and / or return to the default 

values of a set of parameters (+WSPPA). 
Advantageously, it also uses at least one query command by an external 
5 application, preferably two query commands by an external application, on the following 
in turn: 

- the current state of the connection (+WSPICON); 

- reception and / or sending of a message (+WSPIMSG). 

An embodiment of invention also relates to the method for remote control of 
1 0 equipment used by a system as described above. It enables interconnection between at 
least one server and at least one remote equipment according to the MQIsdp protocol by 
associating at least one of the said remote items with radiocommunication means 
capable of sending and receiving AT type commands sent by and / or to be sent to an 
external application used by the said remote equipment, and by using a set of special AT 
1 5 commands in the said radiocommunication means for exchanging data with at least one 
server using the said MQIsdp protocol. This enables an interconnection between the said 
server(s) and the said remote equipment through the said radiocommunication means, 
without requiring additional processing and / or data formatting means in the said remote 
equipment. 

2 0 An embodiment of invention also relates to radiocommunication devices and 

modules comprising radiocommunication means used in such an equipment remote 
control system. 

A further embodiment of the invention relates to sets of AT commands used in 
an equipment remote control system, used to exchange data with at least one server 
2 5 using the said MQIsdp protocol. 

Other special features and advantages of one or more embodiments of the 
invention will become clearer after reading the following description of a preferred 
embodiment of the invention, given as a simple illustrative and non-limitative example 
and appended figures. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

- Figure 1 shows an example of a system in which an embodiment of the 
invention could be used; 

- Figure 2 shows an example of how the MQIsdp protocol can be integrated in 
5 an Open- AT application; and 

- Figures 3A to 3L show different example embodiments of a connection 
according to embodiments of the invention. 

DETAILED DESCRIPTION OF ILLUSTRATIVE EMBODIMENTS 
1. Reminders about the MQIsdp protocol (registered trademark) 

1 0 The MQIsdp (WebSphere MQ Integrator SCADA device protocol) is an open 

standard developed by IBM and Arcom Control Systems (registered trademarks), to 
enable data exchanges (in the form of messages) from generally inexpensive remote 
devices (or terminals) with little processing power, to a WebSphere MQ Integrator by 
TCP/IP server, also called a broker in the following, and vice versa. 

15 MQIsdp (also called Wavecom SCADA in the following) is a data (message) 

transfer protocol based on a publish / subscribe type communication model freely 
available on Internet. It may be described as being a simple agnostic data management 
layer above the TCP/IP protocol, for message management and acknowledgements of 
reception necessary to assure reliable delivery of the message. 

2 0 In the publish / subscribe communication model, data are exchanged between a 

data producer / consumer (the client) and a message broker (the server). The message 
broker may be considered as being a multi-protocol switching hub for the application 
protocol that receives the messages, and it transforms them, reformats them, etc. into 
other structures as a function of a data model defined by the user. 

2 5 Finally, any transformed messages may be sent (published) by the broker to 

subscriber clients (zone device, ERP, SAP, Oracle, SQL, etc.) using appropriate client 
cards. Obviously, the broker can also publish messages that do not originate from a 
client. 
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The message broker manages all messages input to and output from an item. A 
client publishes messages in / with an item or subscribes to messages from / by an item 
identifying the message flow from the message broker to which or from which the 
message is to be published. 
5 The MQIsdp specification defines a set of very simple messages including 

"connect", "disconnect", "publish", "subscribe", and "unsubscribe". 

2. Principles of an embodiment of the invention 

2.1 General 

Therefore, one or more embodiments of the invention relate to a new approach 

1 0 for remote control of equipment, particularly based on the use of a set of special AT type 
commands, enabling an external application to manage data exchanges between a 
remote terminal and a server, through radiocommunication links (for example a Wismo 
type (registered trademark) module), without the application knowing the MQIsdp 
protocol used by the server. This aspect is managed by radiocommunication means, and 

1 5 for example acknowledgements described in the MQIsdp protocol. 

Figure 1 is a simplified illustration of the principle of an embodiment of the 
invention. The objective is to have any type of remote machine, for example 
measurement instruments 11, communicate with one or several applications hosted on 
servers 12, capable of receiving data 13 using the MQIsdp protocol, and to transform, 

2 0 process or transmit these data. 

According to this embodiment, the remote terminals (or machines) 11 are 
associated with radiocommunication means 14, for example in the form of a Wismo 
module (registered trademark) particularly embedding development tools distributed by 
the applicant under the "Muse platform" trademark). 

2 5 2.2 Module concept 

As a reminder, it should be noted that most radiocommunication devices 
conventionally comprise a set of electronic components arranged on a printed circuit. 
These various components are designed to perform the various necessary functions, 
from reception of a RF signal until generation of an audible signal (in the case of a 
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radiotelephone) and vice versa. Some of these functions are analogue and others are 
digital. 

Manufacturing of these radiocommunication devices is an important subject of 
research. Three objectives are aimed at, that are difficult to reconcile: miniaturising 
5 devices, increasing features and simplifying assembly. It is known that installation of 
different components on a printed circuit is a relatively complex operation, since many 
components have to be arranged on a very restricted surface area, due to miniaturization 
requirements. 

Therefore, the design of these systems is complex, since it also requires a 
1 0 combination of various components, often from multiple sources, that have to be made 
to operate together, respecting the specific features of each. Furthermore, after 
assembling the set of components, calibration and test phases that are frequently long 
and complex are necessary to guarantee correct operation of the device. 

Finally, despite the reduction in size of some components, the assembly occupies 
15 a certain surface area that is difficult to reduce. 

The holder of this patent application has proposed a method of overcoming some 
of these disadvantages, consisting of grouping all or at least some of the functions of a 
digital radiocommunication device in a single module. 

Such a module is in the form of a single compact housing, preferably shielded, 
2 0 that device manufacturers can integrate directly without needing to take account of a 
multitude of components. 

This module (also sometimes called a "macro-component") is actually formed by 
grouping several components on a substrate, so as to be implanted in the form of a single 
element. It includes essential components and software necessary for operation of a 
2 5 communication terminal using radio-electrical frequencies. Therefore, there is no longer 
a set of complex steps for the conceptual design and validation of this terminal. All that 
is necessary is to reserve the space necessary for the module. 
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Therefore, such a module can be used to easily and quickly integrate all 
components into wireless terminals in an optimised manner (portable telephones, 
modems or any other application using a wireless standard). 

Furthermore, since this module contains all essential functions and has been 
5 designed as a complete unit, calibration and test problems no longer arise in the same 
manner, or are at least very much simplified. 

Thus, modules distributed by the holder of this patent application are fully tested 
both in terms of hardware and software on most networks on which they could be used 
later. Furthermore, the module advantageously encompasses industrial proprietary 
10 aspects (since all functions have been grouped together, the module manufacturer 
manages the corresponding patent right aspects) and technical support aspects. 

2.3 AT commands 

The principle of using AT commands is already known. For example, it is 
described in patent document FR-99 13645, and in various specifications distributed by 
1 5 the applicant and that can be referred to for further information if necessary. 

2.4 New AT commands 

This module 14 is capable of managing a small number of simple AT commands, 
enabling a simple and efficient dialog with an external application associated with a 
terminal. It makes the transformation to the MQIsdp format and manages sending and 
2 0 receiving of data 15 using this protocol, in a manner transparent for the application. 

Thus, the data exchange can be made using radio waves 16, for example 
according to the GSM or GPRS standard. Seen from the server 12, information is in the 
MQIsdp format. There is no need for terminals 1 1 to know this protocol, they only need 
to know a few AT commands. It is thus easy and inexpensive to implement an external 
2 5 application at low cost in (or adjacent to) a terminal without the need to provide a 
microprocessor and memories, and a dedicated application. 

As will be seen later, the proposed AT commands may be limited to 8, although 
they can be upgraded. 

Two data transfer modes are proposed: 
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- data transit through the module 14. These data are temporarily stored in buffers 
(buffer memories), the size of which can be configured as a function of needs; 

- data are transmitted directly between the terminal and the server, without being 
stored in memory in the module 14, the module 14 only managing all signalling aspects 

5 (opening and closing of the connection, acknowledgements, etc.). 

The first case could correspond to the most frequent case of small messages, and 
the second case to the transfer of large files, as is allowed for in the MQIsdp protocol. It 
is thus possible to manage everything through the module, without adding any external 
memory and intelligence, while enabling data transfers with a volume greater than the 
1 0 storage capacity of the module. 

Advantageously, a single command can be used for sizing of buffers and 
changing from one mode to the other (the second mode corresponding to a zero value). 

Figure 2 shows a simplified example of a software architecture that could be used 
in the module 14. 
1 5 Such a module 14 usually comprises: 

- a basic software layer 21 (Wavecom Core Software); 

- an Open AT library 22; 

- an ADL library 23; 

- a TCP/IP library 24; 

2 0 - an application layer 25 (Open AT Application). 

According to an embodiment of the invention, a library 26 of special commands 
(Wavecom SCADA Protocol Library) is provided to communicate using the MQIsdp 
protocol that is above the TCP/IP library 24. 

The AT commands 27 address either the base layer 21, the TCP/IP library 24 or 
2 5 the SCADA library 26 depending on the case. 

The proposed interface using AT commands includes only 8 commands in this 
library 26, capable of fully controlling the MQIsdp protocol and particularly: 

- possibility of sizing two internal queues for managing incoming and outgoing 
messages; 
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- possibility of outsourcing management of large messages; 

- definition of connection contexts; 

- management of configuration parameters; 

- management of sending different types of messages by generic command. 
5 3. Detailed description of an embodiment of commands 

The following describes AT commands that could be used to control the 
Wavecom SCADA protocol 26. 

3.1 Related documents 

If necessary, the following documents provide useful information: 
10 [1] This document should be read with the "WebSphere MQ Integrator SCADA 

Device Protocol" datasheet given in Appendix B of the "IBM WebSphere MQ Integrator 
Programming Guide" reference manual available at the following address: 
http://publifp.boulder.ibm.com/epubs/odf/bipval04.pdf 
[2] Wavecom AT Commands Interface Guide 
1 5 Reference: WM_SW_OAT_IFS_001 - revision: 009 or more recent versions. 

This document describes AT commands managed by the Wavecom product to 
manage related GSM events or services. 

[3] AT Command Interface for TCP/IP 
Revision: 1.7 

2 0 This document describes the parameters and the set of AT commands for 

configuration and control of superposition of TCP/IP and protocols available on 
Wavecom products. 

3.2 Abbreviations and definitions 
3.2.1 Abbreviations 

2 5 APN Access Point Name 

AT: Attention 
DNS Domain Name System 
ISP Internet Service Provider 
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ME Mobile Equipment 

SCADA Supervisory Control and Data Acquisition 



MS 



Mobile Station 



QoS 



Quality of Service 



5 



Wavecom core software: 



Software layer managing all AT commands so that related GSM events or 
services can be managed. 
3.2.2 Definitions 

The terms MS and ME are used for mobile terminals handling GSM services. 
1 0 The word "product" refers to any Wavecom product (particularly a module) handling the 
AT commands interface . 
Symbols: 

<CR> carriage return character 
<LP> line feed character 
15 [...] optional parameter of an AT command 

<...> Parameter name between angle brackets. The angle brackets do not 
appear on the command line. 

3.3 AT command syn tax 

This section defines the format of AT commands, and mechanisms for 
2 0 assignment of default values of their parameters. 

3.3.1 Command lin e 

Commands always begin with the standard "AT+WSP" prefix and finish with the 
<CR> character. 

Optional parameters are indicated between square brackets []. 
2 5 For example: AT + WSPCmd = <Paraml>[,<Param2>] 

In this example, <Param2> is optional. When the AT + WSPCmd command is 
executed without <Param2>, the default value of the <Param2> parameter is used. 

3.3.2 Information responses and result codes 
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Responses begin and end with <CR> <LF> (except for the format of the ATVO 
DCE response) and ATQ1 commands (deletion of result code) (see the related document 
[2]). 

If the command syntax is incorrect, the command is returned to the 
5 Wavecom central software for processing. In this case, the Wavecom central software 
returns the "ERROR" message. 

If the command syntax is correct but incorrect parameters have been 
transmitted, the <CR> <LF> + WSP ERROR: <Err> <CR> <LF> response is returned 
together with appropriate error codes. 
10 . If the command line was executed successfully, the <CR> <LF> "OK" 

<CR> <LF> string is returned. 

3.4 Configuration commands 

Different parameters are necessary to provide the Wavecom product with all 
information about the initial connection: 
15 . The support network used: GSM or GPRS 

Timeout parameters 

The functional mode of superposition of the Wavecom SCADA protocol 
All necessary information about the support network so that a TCP/IP 
infrastructure can be accessed 
2 0 . The "Will" configuration message for the connection. 

3.4.1 + WSPGSET General parameters 
a - Description 

This command is used to configure all parameters used to select the support 
network, the different timeouts and the functional mode of the Wavecom SCADA 
2 5 protocol. 



b - Syntax 



Command 


Possible responses 


AT + WSPGSET = 


OK 
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<Mode>[,<Paramid> [<Value>]] 


Or 




+WSPGSET: <Paramid>, <Value> 




OK 




Or 




TVV jiUjL 1 . v>r dldllllQl^*, s V alUC/ 




+WSPGSET: <Paramid2>, <Value> 




+WSPGSET: <Paramidll>, <Value> OK 




Or 




Error codes 


Note.' configures or lists oil general 


+WSP ERROR: 4000 


parameters. 


+WSP ERROR: 4001 


AT + WSPGSET? 


OK 


Note: no action 




AT + WSPGSET? 


+WSPGSET: (list of <Mode> handled), 


Note: possible values 


(range of <Paramid> values handled) 




OK 



c - Defined values 

<Mode> 02 Execution mode 

0 Assigns the value indicated by <Value> to the parameter 
5 defined by <Parameterid> 

1 Reads the current value of the parameter defined by 

<Parameterid> 

2 Reads the current value of all parameters 

<Value> (0 - 32767) Value of the parameter indicated by <Paramid> 
10 <Paramid> (1 - ll)The following table contains the list of the various 

parameters. 
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P3.r3.micl 


Parameter 


Description 


Format 


Specifications 


Vttluc by 


1 


(BearerSet) 


Select 


Numeric 


0 - 1 


0 






GSM/GPRS 




0 GSM (ISP 












parameters 












are used for a 












connection) 












1GPRS 












(APN 












parameters 












are used for a 












connection) 




2 


<Watchdog> 


Number of 
seconds 
before the 
connection 
is 

interrupted 
after a given 
period with 
no traffic. 
The value 0 
is used to 
indicate that 
the 

exchange 
monitoring 


Numeric 


(0 - 1000) 


0 
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circuit is 
missing. 








3 




JN umber oi 


Numeric 


(ft ^\ 


Q 






unsuccessful 












connection 












attempts 
before 












terminating 












the 












connection 












attempts 












activity 









4 


<NotifyLevel> 


Indication 


Numeric 


(0-3) 


3 






level about 




ONo 








events 




notification 








related to 




1 Notify 








connections 




connection 








and / or 




elements 








messages as 




2 Notify 








unsolicited 




message 








responses 




events 








(see the 




3 Notify all 








chapter on 




events 








WSP 












indications) 








5 


<OutBoxSize> 


Size of the 


Numeric 


(0-32787) 


32787 






Outbox 
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queue in 












^ yt6S h 










<InB oxS ize> 






(0-32787) 


32787 






Inbox queue 












in bytes 








7 


<ReadyMsgMode> 




Numeric 










parameter is 




0 End of 








used, when 




output 








the value 0 is 




\Oy LI \S>\ S> 








as signed to 




Ctrl>C) 












header 1 ^ 








queue All 












messages 




(LJVr, l^OS, 








sent by the 




Retain, etc.) 








broker are 




1 FnH nf 








automatically 




output with 








sent to the 




display of 








external 




header 








application 
























chapter on 












WSP 












indications) 








8 


<WillMsgTimer> 


Number of 


Numeric 


(1 -255) 


5 






seconds 












waiting for 












the "Will" 












message 
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configuration 
command 








9 


<RetryMsgDelay> 


Number of 
milliseconds 
to retry 
sending a 
message 


Numeric 


(0 - 255) 


1 


10 


<RetryMsgCount> 


Number of 
unsuccessful 
attempts to 
send a 
message 
before the 
send attempt 
activity is 
cancelled 


Numeric 


(1 - 10) 


0 


11 


<RetryMsgTimer> 


Number of 
seconds 
waiting for 
reception of 
a message 


Numeric 


(1 - 233) 


0 



d - Possible error codes 

+WSP ERROR 4000 Non-activated function of the Wavecom 

SCADA protocol. This error is returned when 
the function of the Wavecom SCADA 
protocol has not been activated in the 
WISMO module. 
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+WSP ERROR 4001 Illegal operation. This error is returned when 

an incorrect parameter is detected. 



e - Informative examples 



Command 


Responses 


AT + WSPGSET = 0,1,1 


OK 


Note: configures the support network 


Note: GPRS selected 


AT + WSPGSET = 0,4,2 


OK 


Note: configures the <NotifyLevel> 
parameter 


Note: only message events are notified 


AT + WSPGSET = 0,1,2 


+WSPERROR:4001 


Note: configures a parameter with an 
incorrect value 


Note: illegal operation 


AT + WSPGSET = 1,1 


+WSPGSET:1,1 


Note: reads the current value of the 
<BearerSet> parameter 


OK 


AT + WSPGSET = 2 


WSPGSET: 1,0 

WSPGSET:2,0 

WSPGSET:3,0 

WSPGSET:4,3 

WSPGSET:5,32767 

WSPGSET:6,32767 

WSPGSET:7,0 

WSPGSET:8,5 
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Note: reads all current values 


WSPGSET:9,1 
WSPGSET:10,0 
WSPGSET:11,0 
OK 


AT+WSPGSET=? 


+WSPGSET: (0-2),(l-lll) 


Note: possible values 


OK 


3.4.2 Connection parameters +WSPCSET 
a - Description 

This command is used to configure all connection parameters (by family). 
b - Syntax 


Command 


Possible responses 


AT + WSPCSET = <Setting_type>, 


OK 


<paraml> [,<param2> [,<param3> 
[,<param4> [,<param5>]]]]] 


+WSP ERROR:4000 
+WSPERROR:4001 


Note: configures all connection 
parameters. 




AT + WSPCSET? 


+WSPCSET = <Setting_typel>, 
<paraml>, <param2>, <param3> [,... 
[,<paramE>]] 
<CR> <LF> 

+WSPCSET = <Setting_type2>, 
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Note: current values of parameters 


<paraml>, <param2>, 




<param3>[, . . . ] ,<paramE>] ] 




OK 


AT + WSPCSET = ? 


+WSPCSET: (list of <Setting typo 


Note: possible values 


managed 
OK 


c - defined values 




<Settings_type> (0-1) 


Parameter category 




0 ISP parameters 



1 APN parameters 



* IPS parameters (5 parameters) - Settings_type=0 
5 These parameters are used when the GSM support network (given by circuit 

switching) is selected. See the "Other parameters" section. 



Generic 
parameter 


Parameter 


Description 


Format 


Specifications 


Default 
value 


<Paraml> 


<PhoneNumber> 


ISP 

telephone 
number 


Numeric 
string 


Maximum length 
61 




<Param2> 


<UserName> 


ISP 

account 
user name 


Alphanumeric 
string 


Maximum length 
32 




<Param3> 


<Password> 


ISP 

account 
password 


Alphanumeric 
string 


Maximum length 
32 




<Param4> 


<DNS1> 


Main DNS 
IP address 


Alphanumeric 
string 


IP address format 
(1.1.1.1 - 
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255.255.255.255) 




<Param5> 


<DNS2> 


Secondary 
DNS IP 
address 


Alphanumeric 
string 


IP address format 
(1.1.1.1 - 
255.255.255.255) 





* APN parameters (3 parameters) - Settings_type=l 

These parameters are used when the GPRS support network is selected. See the 
5 "Other parameters" section. 



Generic 
parameter 


Parameter 


Description 


Format 


Specifications 


Default 
value 


<Paraml> 


<APN> 


APN from 
the GSM 
operator to 
supply the 
GPRS 
access 


Alphanumeric 
string 


Maximum 
length 64 




<Param2> 


<UserName> 


APN user 
name from 
the GSM 
operator to 
supply the 
GPRS 
access 


Alphanumeric 
string 


Maximum 
length 32 


** 


<Param3> 


<Password> 


APN 
password 
from the 


Alphanumeric 
string 


Maximum 
length 32 
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GSM 

operator to 
provide 
access to 
the GPRS 









W5 1.1 2-0024 



-25- 



d - Possible error codes 

+WSP ERROR 4000 Non-activated function of the Wavecom 

SCADA protocol. This error is returned when 
the function of the Wavecom SCADA 
protocol has not been activated in the 
WISMO module. 

+WSP ERROR 4001 Illegal operation. This error is returned when 

an incorrect parameter is detected. 



e - Informative examples 



Command 


Responses 


AT + WSPCSET = 0, "+336 122 14629", 
"toto", "secret", 
"1.2.3.4", "5.6.7.8" 

Note: configures all ISP parameters 


OK 

Note: new ISP parameters recorded 


AT + WSPCSET = 0„„" 1.2.3.4", 
"1.2.3.5" 

Note: Only configures the DNS1 and 
DNS2 parameters 


OK 

Note: new parameters recorded 


AT+WSPCSET=0",+33612214829", 
"toto", "secret", "256.2.3.4", "0.0.0.0" 

Note: configures all parameters with an 
incorrect parameter (DNS1 ) 


+WSPERROR:4001 
Note: illegal operation 


AT + WSPCSET = 1, "Orange", "toto", 
"secret" 


OK 
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Note: configures all APN parameters 


Note: new parameters recorded 


AT + WSPCSET = 1„ "toto", "secret" 

Note: only configures the "UserName" 
and "Password" parameters 


OK 

Note: new parameters recorded 


AT + XSPCSET = 1, "Orange.fr", 
"toto", 1 

Note: configures all parameters with an 
incorrect parameter (Password: 
password) 


+WSPERROR:4001 

Note: illegal operation 


AT + WSPCSET? 

Note: current values 


+WSPCSET:0,"+ 33612214629", "toto", 
"secret", "L2.3.4","5.6.7.8" 
+WSPCSET:1, "Orange.fr", "toto", 
"secret" 
OK 

Note: range of values recorded 


AT + WSPCSET = ? 

Note: possible values 


+WSPCSET: (0-1) 
OK 

Note: values managed 



3.4.3 Parameters for the Will + WSPWMS message 
a - Description 
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This command configures all parameters related to the Will message. This 
command returns +WSP ERROR: 4013 if the value 0 is assigned to the <OutBoxSize> 
parameter. 

b - Syntax 



Command 


Possible responses 


AT + WSPWMS = <Topic> 


> 


[,<Qos>[,<Retain> 


Or 


[,<PayloadLength>] ] ] <CR>, 


Error code: 


Enter <PayloadLength> the number of 


+WSP ERROR:4000 


bytes indicated, by the <CrVIs a Len a tli!> 


+WSPERROR:4001 


parameter 


+WSP ERROR:4002 


Or 




Enter< Payload> <Ctrl>P <Ctrl>C when 




the <PayloadLength> parameter is not 




defined 




Nota configures all pciTayne.te.TS in the 




Will message. 




AT + WSPWMS? 


+WSPWMS: <Topic>, <Qos>, <Retain> 




<CR> <LF> <Payload> 


Note: returns information from the Will 


OK 


message 




AT + WSPWMS = ? 


+WSPWMS: (maximum length of a 




<Topic>, (list of <Qos> accepted), (list 




of <Retain> accepted), (range of 


Note: possible values 


<PayloadLength> accepted) 




OK 
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c - defined values 
<Topic> 



This string identifies the information channel 
on which text data were published. 
Maximum length = 64 characters 



<Qos> (0 - 2) 



Quality of service 

Once maximum - <Fire and Forget> 
At least once - Delivery 
acknowledgement of reception 
Exactly once - Delivery guaranteed 
Default value = 0 



<Retain> (0-1) 



Informs the broker that the message must be 
retained and sent to any new subscriber to 
this item as the initial message. 
Default value = 0 



<PayloadLength> 



Maximum length of the message body. This 
value is limited by the value of the 
<OutBoxSize> parameter. If the value 0 is 
assigned to the <OutBoxSize> parameter, 
this value is no longer limited (see the 
+WSPGSET command section for further 
information about the <OutBoxSize> 
parameter). 



d - Possible error codes 
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+WSP ERROR 4000 Non-activated function of the Wavecom 

SCADA protocol. 

This error is returned when the function of the 
Wavecom SCADA protocol has not been 
activated in the WISMO module. 

+WSP ERROR 4001 Illegal operation. This error is returned when 

an incorrect parameter is detected. 

+WSP ERROR 4002 Operation not accepted by the current 

configuration. 
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e - Informative examples 



Command 


Responses 


AT + WSPWMS = My Will Topic", 0, 0 

Note: Enters will information without the 
body length 


> 

Note: wait for the end of the text defined 
by <ctrl>P<ctrl>C 


My body will message fr 
Test <ctrl>P <ctrl>C 
Note: enter the text 


OK 

Note: text entered 


AT + WSPWMS = "My Will Topic", 0, 
10 

Note: enters will information with an 
incorrect parameter ( <Retain>) 


+WSP ERROR: 4001 
Note: illegal operation 


AT + WSPWMS? 

Note: Reads all information about the 
Will message 


+WSPWMS: "My Will Topic", 0.0 
My body will message test 

OK 

Note: the connection is set up with the 
broker 


AT+XSPWMS=? 

Note: possible values 


+WSPWMS:64, (0-2), (0-1), 32767 
OK 



Note: if the <ctrl>P command is present in the text, the <ctrl>P <ctrl>P escape 
command will have to be used. 



3.5 - General commands 
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3.5.1 - Definition of the WSP + WSPDCONT context 
a - Description 

This command defines parameter values for a WSP context identified by the 
local context identification parameter <WSPCid>. 
5 A maximum of two WSP contexts can be defined. 

A special form of the defined command, +WSPDCONT = <WSPCid>, is used to 



delete a WSP context. 

b - Syntax 



Command 


Possible responses 


AT + WSPDCONT = <WSPCid>[, 
[<Clientid>], [<broker_Adr>], [<Port>], 
[<CleanStart_Flag>], 
[<Keep AliveTimer>] , 
[<UseLWT_Flag>]] 


OK 

+WSP ERROR: 4000 
+WSP ERROR: 4001 


Note: creates a new context 




AT+WSPDCONT? 


+WSPDCONT: <WSPCidl>, 
<Clientidl>, <Broker_Addrl>, <Portl>, 
<CleanStart_Flagl>, 
<KeepAliveTimerl>, 
<UseLWT_Flagl>, 


Note: lists all created contexts 


+WSPDCONT:<WSPCid2>, 

<Clientid2>, <Broker_Addr2>, <Port2>, 

<CleanStart_Flag2>, 

<KeepAliveTimer2>, 

<UseLWT_Flag2>, 

OK 
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AT+WSPCONT=? 


+WSPCONT: (list of <WSPCid> 








(max length of<Broker_Addr>), (range 




of <Port> accepted), (list of 




<CleanStart_Flag> accepted), (list of 




<KeepAliveTimer> accepted), (list of 




<UseLWT_Flag> accepted). 


Note: possible values 


OK 



c - Defined values 
<WSPCid> (1-2) 



<Broker_Addr> 



WSP context identifier: numeric parameter that 
indicates a definition of a given WSP context. 
Client identifier for the Wavecom SCADA 
protocol: string parameter that identifies the client. 
Maximum length = 23 characters 
Default value = unreadable 

Parameter on string (or IP address) that identifies 
the broker server and provides a means of reaching 



<Port> (0 - 65535) 



<CleanStart_Flag> (0-1) 
0 

1 



Maximum length = 255 characters 
Default value = unreadable 

Numeric parameter (broker port) used to reach the 
broker server to transfer data. 
Default values = 1883 

The client continues with the previous connection 
data. 

The broker cancels all pending messages for the 
client, deletes all client subscriptions and reassigns 
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the value 1 to the message ID. 




Default value = 0 


<Keep Ali veTimer> 


Maximum interval between each client message. 


(0-32767) 


The value 0 indicates that no connection holding 




(Keep Alive) timeout processing is made 




Default value = 0 


<UseLWT_Flag> (0-1) 


Indicates if the Will message is used: 


0 


The Will message is not used 


1 


The Will message is used 




Default value = 0 


d - possible error codes 


+WSP ERROR 4000 


Non-activated function of the Wavecom SCADA 




protocol. This error is returned when the function of 




the Wavecom SCADA protocol has not been 




activated in the WISMO module. 


+WSP ERROR 4001 


Illegal operation. This error is returned when an 




incorrect parameter is detected. 


e - Informative examples 


Command 


Possible responses 


AT + WSPDCONT = 


OK 


1,1. "1.2.3.4", 1883,1.0.1 






Note: context created 


Note: creates a new 




context 




AT + WSPDCONT = 


OK 


2,1,"5,6,7,8" 
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Note: creates a new 
context with default 
parameters 


Note: context created 


AT + WSPDCONT = 2 


OK 


Note: deletes a context 


Note: context deleted 


AT + WSPDCONT = 
10,1,"L2.3.4"1883 

Note: creates a new 
context with an 
incorrect parameter 
(Cid) 


+WSP ERROR:4001 

Note: illegal operation 


AT + WSPDCONT = 

2,1,"5,6,7,8" 

Note: creates a new 
context with default 
parameters 


OK 

Note: context created 


AT + WSPDCONT? 


+WSPDCONT:l,l,"1.2.3.4", 1883,1,0,1 
+WSPDCONT:2,1,"5.6.7.8",1883,1,0,1 


Note: lists all created 
contexts 


OK 


AT+WSPDCONT? 

Note: possible values 


+WSPDCONT:(1-2),23,255,(0-06535),(0-1),(0-32767),(0-1) 
OK 
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3.5.2 + WSPCONM connection management 
a - Description 

This command manages the connection to a broker. 



5 b - Syntax 



Command 


Possible responses 


AT + WSPCONM = <Mode> 
[,<WSPCid> [,<CleanDisconnect>]] 

Note: connection / disconnection 
operations 


OK 
Or 

Error codes: 
+WSP ERROR:4000 
+WSPERROR:4001 
+WSP ERROR:4003 

+WSPERROR:40010 


AT+WSPCONM? 


+WSPCONM:<Status> [,<WSPCid>] 


Note: returns the connection status 


OK 


AT + WSPCONM = ? 


+WSPCONM: (list of <Mode> 
accepted), (list of WSPCid> accepted), 
(list of <CleanDisconnect> accepted) 


Note: possible values 


OK 


c - defined values 



<Mode> (0-1) 0 Disconnection of an active Wavecom SCADA 

protocol session 
1 Connection to the remote broker 
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2 

<WSPCid> 



<CleanDisconnect> 

(0-1) 
0 



1 

<Status> (0 - 2) 

0 
1 
2 

d - Possible error codes 
+WSP ERROR 4000 



+WSP ERROR 4001 

+WSP ERROR 4003 
+WSP ERROR 4004 
+WSP ERROR 4005 



-36- 

Connection aborted 

WSP context identifier: numeric parameter that 
identifies the definition of a given WSP 
context. 

Disconnection mode 

Disconnection takes place immediately, the 

queue is emptied and all in-progress 

transactions are deleted. 

All queued messages (waiting or pending) are 

processed before the disconnection. 

Default value = 1 

Connection status with the broker. 

Not connected 

Connected 

Connection pending 



Non-activated function of the Wavecom 
SCADA protocol. This error is returned when 
the function of the Wavecom SCADA protocol 
has not been activated in the WIS MO module. 
Illegal operation. This error is returned when 
an incorrect parameter is detected. 
WSP context not defined 
Client already connected 
Connection pending 
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+WSP ERROR 4006 
+WSP ERROR 4007 



+WSP ERROR 4008 
+WSP ERROR 4009 
+WSP ERROR 40010 



Disconnection pending 

Client not connected. This error is sent when a 
disconnection is requested whereas the ME is 
not connected 
No network 
No GPRS 
No TCP/IP 



e - Informative examples 


Command 


Possible responses 


AT + WSPCONM? 

Note: obtains the current status of the 
connection 


+WSPCONM:0 
OK 

Note: the module is not connected to the 
broker. 


AT + WSPCONm=l,l 


OK 


Note: connection operation with WSP1 
context 


Note: connection operation started 


AT + WSPCONM? 


+WSPCONM:2,l 
OK 


Note: obtains the current status of the 
connection 


Note: connection operation pending 


AT + WSPCONM = 1,2 


+WSP ERROR: 4004 


Note: another connection is requested 


Note: operation not managed 


AT + WSPCONM? 


+WSPCONM:l,l 
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Note: obtains the current status of the 
connection 


OK 

Note: the connection is set up with the 
broker 


AT+ WSPCONM=0,0 

Note: disconnection with reset of queues 


OK 


AT + WSPCONM = ? 
Note: possible values 


+WSPCONM:(0-1),(1-2),(0-1) 
OK 



3.5.3 - Send message +WSPSMSG 
a - Description 

This command sends or obtains the status of several message types, and 
5 particularly Publish, Subscribe and Unsubscribe. 

The specification of the Wavecom SCADA protocol enables a SUBSCRIBE / 
UNSUBSCRIBE message to send several subscriptions / unsubscriptions. The limit for 
this AT command is fixed at one item per SUBSCRIBE / UNSUBSCRIBE message. In 
this case, an application that wants to subscribe / unsubscribe from several items will 
1 0 send several SUBSCRIBE / UNSUBSCRIBE requests for a single item. 



b - Syntax 


Command 


Possible responses 


AT + WSPSMSG = <ActionType> 


When a message is sent 


[,<Paraml> [,<Param2> [,<Param3> 


+WSPSMSG: <MsgHandle> 


[,<Param4> [,<Param5> 


OK 


[,<Param6>]]]<CR> 


Or 




When a message status is requested 
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TWorolvlou. <.o UUU»,> 




OK 




Or 




Error code: 




+WSP ERROR:4000 




+WSPERROR:4001 




+WSP ERROR:4007 


Note: configures all message parameters 


+WSPERROR:40011 


AT + WSPSMSG? 


OK 


Note: no effect 




AT + WSPSMSG = ? 


+WSPSMSG: (list of <ActionType> 




managed) 


Note: possible values 






OK 



c - Defined values 
<ActionType> Operation type 

0 Send a message 

1 Obtain the message status 

5 

* Send a message (5 parameters) - ActionType = 0 



Generic 
parameter 


Context parameter 


Description 


Format 


Specifications 


Default 
value 


<Paraml> 


<MsgType> 


Message 
identifier 


Numeric 


(3,8,10) 
3 Publish 


NA 
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8 Subscribe 
10 Unsubscribe 




<Param2> 


<Topic> 


String 

indicating 

the 

information 
channel on 
which text 
data are 
sent 


Alphanumeric 
string 


Maximum length 
64 




<Param3> 


<QoS> 


Quality of 
Service 


Numeric 


(0-2) 

0 - Fire and 
forget 

1 - Delivery with 
acknowledgement 
of reception 

2 - Delivery 
guaranteed 


0 


<Param4> 


<Retain> 


Notifies the 
broker that 
the message 
must be 
kept and 
must be 
sent as the 
initial 
message to 
any new 


Numeric 


(0-1) 


0 
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subscriber 
to this item 








<Param5> 


<DupFlag> 


Double 
indicating 
message 
used only if 
OutBoxSize 
= 0 


Numeric 


(0- 1) 

0 - first send 

1 - duplicated 
message 


0 


<Param6> 


<PayLoadLength> 


Maximum 
length of 
the message 
body 


Numeric 


(*) 


0** 



(*) Maximum length of the message body. This value is limited by the value of 
the <OutBoxSize> parameter. If the value 0 is assigned to the <OutBoxSize> parameter, 
there is no limit (see the +WSPGSET command section for further information about the 
<OutBoxSize> parameter). 



5 Note: if MsgType = 1 0 (UNSUBSCRIBE), then 

only the <Topic> parameter is compulsory. 
Else, if MsgType=8 (SUBSCRIBE) then 

the <Topic> and <QoS> parameters are used. If the <QoS> parameter 
is activated, then the default value is used. 
1 0 Else, if MsgType=3 (PUBLISH) then 

all parameters are used. If the <QoS> and <Retain> parameters are 
omitted, the default values are used. 
Then, assign the number of bytes indicated by the <PayLoadLength> parameter 
to the <Payload> parameter. 
15 Or 
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Enter <PayLoad> <Ctrl>P <Ctrl>C when the <PayLoadLength> 
parameter is omitted. 



* Obtain the status (1 parameter) - ActionType = 1 



Generic 


Context 


Description 


Format 


Specifications 


Default 


parameter 


parameter 








value 


<Paraml> 


<MsgHandle> 


Numeric. 
Identifies 
the 

message 


Numeric 


(0 - 32767) 


NA 



5 

<Status> Message status 



W WAITING. The message is queued, the transaction has not 
begun. 

P PENDING. The message is queued. The transaction is in 
progress. 

N Message cannot be found. The message is not in the queue. 
Either the transaction is terminated, or the message was 
never put in a queue. 

d - Possible error codes 

+WSP ERROR 4000 Non-activated function of the Wavecom 
SCADA protocol. This error is returned when 
the function of the Wavecom SCADA protocol 
has not been activated in the WISMO module. 

+WSP ERROR 4001 Illegal operation. This error is returned when 
an incorrect parameter is detected. 

+WSP ERROR 4007 Client not connected. 
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+WSP ERROR 400 1 1 Queue saturated 



e - Informative examples 



Command 


Possible responses 


AT + WSPSMSG=0,3- "My Publish 
Topic",0,0,0 

Note: publishes a message 


> 

Note: waits for the end of the text 
identified by <Ctrl>P <Ctrl>C 


My body publish message for test 
<Ctrl>P <Ctrl>C 


+WSPSMSG:1 
OK 


Note: enter the Payload parameter 


Note: the message is in the internal 
queue or has been sent (if the internal 
queue is not used) 


AT + WSPSMSG= 1,1 


+WSPSMSG:W 
OK 


Note: obtains the message 1 status 


Note: message 


AT + WSPSMSG=0,3- "My Publish 
Topic" 0,10,0 


+WSP ERROR: 4001 


Note: enter the Publish message with an 
incorrect <Retain> parameter 


Note: illegal operation 


AT + WSPSMSG = 0,8. "My Subscribe 
Topic" 


+WSPSMSG:2 
OK 
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Note: Subscribe message in which the 
default value of the <QoS> parameter is 
used 


Note: the message is in the internal 
queue or has been sent (if the internal 
queue was not used) 


AT + WSPSMSG = 0,10, "My 
Unsubscribe Topic" 


+WSPSMSG:3 
OK 


Note: Unsubscribe message 


Note: the message is in the internal 
queue or has been sent (if the internal 
queue was not used) 


Al + WorbJVlbLr/ 


OK 


AT + WSPSMSG=? 


+WSPSMSG:(0,1) 


Note: possible values 


OK 



Notes: 

[1] If there is a <Ctrl>P in the text, the <Ctrl>P <Ctrl>P escape command has to 



be used. 

[2] The <MsgHandle> parameter is only managed if the value 32767 bytes is 
5 assigned to the <OutBoxSize> parameter (see the General parameters section, 
+WSPGSET command). 

When the value 0 is assigned to the <OutBoxSize> parameter, the <MsgHandle> 
parameter is set equal to the value 1 each time. 

3.5.4- Reception of the + WSPRMSG message 
10 a- Description 
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This command is used to read a received message. The message is received with 
the +WSPIMSG indication. 

The broker can send a PUBLISH message to the client on any item to which the 
client is subscribed. This AT command is used to obtain messages arrived in the InBox 
5 queue. 

This AT command is only available if the value 0 is not assigned to the 
<InboxSize> parameter (see general parameters, +WSPGSET command). If the value 0 
is assigned to the <InboxSize> parameter, messages are displayed with the 
+WSPIRMSG indication. 

10 b - Syntax 



Command 


Possible responses 


AT + WSPRMSG = <Msgid>[,<Mode>] 


+WSPRMSG:<Msgid> 


[,<Topic> 




[,<Dup> [,<QoS> 


[,<Retain>[, 




DataLength>]]]]] 






<CR> <LF> 






<Data> 






OK 






Or 






Error codes: 






+WSP ERROR:4000 






+WSP ERROR:4001 




Note: receives a message from the Inbox 


+WSP ERROR:4002 




queue 


+WSPERROR:40012 




AT + WSPRMSG? 

Note: sends the list of messages in the 


+WSPRMSG: <Msgidl> 
+WSPRMSG: <Msgidn> 
OK 
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Inbox queue 




AT + WSPRMSG = ? 

Note: possible values 


+WSPRMSG: (range of <Msgid> 
accepted), (list of <Mode> accepted) 
OK 



c - Defined values 
<Msgid> (0 - 32767) 
<Mode> (0-1) 



Received message identifier 
Reception mode 

0 Output terminated (by <ctrl>P <ctrl>C) 
without the header (DUP, QoS, Retain, etc.) 

1 Output terminated and header displayed 



d - Possible error codes 
+WSP ERROR 4000 



+WSP ERROR 4001 



+WSP ERROR 4002 



+WSP ERROR 40012 



Non-activated function of the Wavecom 
SCADA protocol. This error is returned when 
the function of the Wavecom SCADA protocol 
has not been activated in the WISMO module. 

Illegal operation. This error is returned when 

an incorrect parameter is detected. 

Operation not managed by the current 

configuration. 

Message cannot be found 



? - Informativt 



mmplet 



Command 


Possible responses 


AT + WSPRMSG? 


+WSPCONM:8 
OK 
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Note: obtains the list of messages 
appearing in the InBox queue 


Note: there is a message in the InBox 


AT + WSPRMSG = 8,3 


+WSP ERROR: 4001 


Note: obtains the message with an 
incorrect <Mode> parameter. 


Note: illegal operation 


AT + WSPRMSG = 8,1 


+WSPRMSG=8, "Topic Test", 1,0,1,20 
Receive Message test<CR> <LF> OK 
OK 


Note: obtains the message with the 
associated header 


Note: connection operation started 


AT + WSPRMSG? 


OK 


Note: obtains the current status of the 
connection 


Note: there is no message in the InBox 


AT + WSPRMSG = 10,2 


+WSP ERROR: 4012 


Note: obtains the message with the 
associated header 


Note: message cannot be found 


AT + WSPRMSG? 


+WSPRMSG: (0 - 32767),(0 - 2) 


Note: possible values 


OK 
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3.5.5 + WSPPA protocol administration 
a - Description 

This command makes a general reset in the various queues or restores the default 
values of all parameters. 



5 b - Syntax 



Command 


Possible responses 


AT + WSPPA = <ActionType> 


OK 


Note: performs an action 


Or 

Error codes: 
+WSP ERROR: 4000 
+WSP ERROR: 4001 
+WSP ERROR: 4002 


AT + WSPPA? 


OK 


Note: no effect. 




AT + WSPPA = ? 


+WSPPA: (range of <Action> handled) 


Note: possible values 


OK 


c - defined values 



<ActionType>(0 - 1) 0 Action type 

RESET. Empties the queue and interrupts all 
transactions in progress. 
1 DEFAULT PARAMETERS. All default 
values of parameters of AT commands are 
restored. This action is only possible when 
not connected. 
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d - Possible error codes 

+WSP ERROR 4000 Non-activated function of the Wavecom 

SCADA protocol. This error is returned when 
the function of the Wavecom SCADA 
protocol has not been activated in the 
WISMO module. 

+WSP ERROR 4001 Illegal operation. This error is returned when 

an incorrect parameter is detected. 

+WSP ERROR 4002 Operation not accepted by the current 

configuration. 



e - Informative examples 



Commands 


Possible responses 


AT + WSPPA = 0 


OK 


Note: empties all queues and interrupts 
all transactions in progress. 


Note: reset done. 


AT + WSPPA = 2 


+WSP ERROR: 4001 


Note: perform an action with an 
incorrect <ActionType> parameter 


Note: illegal operation 


AT + WSPPA? 


OK 


Note: no effect 




AT + WSPPA = ? 


+WSPPA: (0 - 1) 


Note: possible values 


OK 



W5 1.1 2-0024 



-50- 



3.6 WSP indications 

This chapter describes all event responses for sent messages. 

3.6.1 +WSPDCONI connection indications 

A connection indication mechanism (+WSPCONI) is set up so that the external 
application can determine the connection status. 

These indications are sent when a value between 1 and 3 is assigned to the 
<NotifyLevel> parameter (see the +WSPGSET command). 

Syntax: +WSPCONI: <Status> 

<Status> 

0 The requested disconnection is terminated 

1 The connection with the broker is set up 

2 The connection with the broker is refused 

3 Protocol version not handled 

4 Identifier rejected by the broker 

5 Will message configuration necessary. This indication is returned only 
when the +WSPWMS command was not configured before the connection. 

6 Allocated time for configuration of the Will message exceeded. Connection 
not set up. 

3.6.2 +WSPSMSGI message send indications 

A (+WSPSMSGI) message indications mechanism is set up so that the external 
application can determine if the message is received or if a message has been sent. 

These indications are sent when the value 2 or 3 is assigned to the <NotifyLevel> 
parameter (see the +WSPGSET command) and if the value 32767 is assigned to the 
<InboxSize> parameter. 

Syntax: + WSPSMSGI: <Status>,<Msgid> 

<Status> 



W5 1.1 2-0024 



-51- 

0 The <Msgid> message has been distributed (QoS>0) 

1 The <Msgid> message has been deleted (all attempts have failed) 
<Msgid> 

(0 - 32767) Message identifier 



3.6.3 + WSPRMSGI message reception indications 

If the Inbox size (<InboxSize>) is zero (0), messages are displayed with the 
+WSPRMSGI indication as soon as they are received. 

These indications are sent when the value 2 or 3 is assigned to the <NotifyLevel> 
parameter (see +WSPGSET command) and when the value 0 is assigned to the 
<InboxSize> parameter. 

The message header and / or the payload are displayed as a function of the 
+WSPGSET RecMsgMode parameter. 

Syntax: +WSPRMSGI: <Status>[, <Msgid>[, <Topic>, <Dup>, <QoS>, 
<Retain>, <Length> <CR> <LF> 

<Data>]] 

<Status> 

0 <WMsgid> message received in the Inbox 

1 Message received. The message is sent directly to the output. 

2 Inbox saturated 

3 No message reception capacity 

4 Message terminated 

5 Incorrect message 

<Msgid> (0 - 32767) Received message identifier 

<Topic> Message item string 

<Dup> (0-1) Double indicator (for QoS 1 and 2) 

<QoS> (0 - 2) Quality of Service for this message 
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<Retain> (0-1) Memorisation indicator (Retain) 

<Length> (0 - Outbox size) 
Payload length 
<Data> Message data 



3. 7 Error codes 

This chapter describes all error codes returned by WSP AT commands. 



Error code 


Meaning 


+WSP ERROR: 4000 


Non-activated function of the Wavecom SCADA 
protocol. This error is returned when the function 
of the Wavecom SCADA protocol has not been 
activated in the WISMO module. 


+WSP ERROR: 4001 


Illegal operation. This error is returned when an 
incorrect parameter value has been used. 


+WSP ERROR: 4002 


Operation not handled by the current 
configuration. 


+WSP ERROR: 4003 


WSP context not defined 


+WSP ERROR: 4004 


Client already connected 


+WSP ERROR: 4005 


Connection operation pending 


+WSP ERROR: 4006 


Disconnection operation pending 


+WSP ERROR: 4007 


Client not connected 


+WSP ERROR: 4008 


No network 


+WSP ERROR: 4009 


No GPRS 


+WSP ERROR: 40010 


No TCP/IP 


+WSP ERROR: 40011 


Queue saturated 


+WSP ERROR: 40012 


Message cannot be found 


+WSP ERROR: 40013 


Connection refused by the broker 


+WSP ERROR: 40014 


Connection refused due to a protocol version not 
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handled 


+WSP ERROR: 40015 


Connection refused: identifier rejected by the 
broker 



4. Examples 

This section gives examples of the use of all AT commands in the Wavecom 
SCADA protocol described above. These examples are shown in Figures 3A to 3K 
5 respectively. 

In these figures, the information is presented using a format well known to those 
skilled in the art, clearly showing data exchanges between the various entities (server or 
broker, module and external application). The fourth column shows which commands 
are used, and their meaning when applicable. 
10 It does not seem necessary to add further comments on these figures, those 

skilled in the art will be capable of interpreting them directly. 

The following aspects are presented: 

4.1 Receiving a message with QoS 0 

4.1.1 With an Inbox (Figure 3A) 
15 4.1.2 Without an Inbox (Figure 3B) 

4.2 Receiving a message with QoS 1 

4.2.1 With an Inbox (Figure 3C) 

4.2.2 Without an Inbox (Figure 3D) 

4.3 Receiving a message with QoS 2 

2 0 4.3. 1 With an Inbox (Figure 3E) 

4.3.2 Without an Inbox (Figure 3F) 

4.4 Sending a message with QoS 0 

4.4.1 With an Outbox (Figure 3G) 

4.4.2 Without an Outbox (Figure 3H) 
2 5 4.5 Sending a message with QoS 1 
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4.5.1 With an Outbox (Figure 31) 

4.5.2 Without an Outbox (Figure 3 J) 

4.6 Sending a message with QoS 2 

4.6.1 With an Outbox (Figure 3K) 
5 4.6.2 Without an Outbox (Figure 3L) 

4.7 Comments 

In these various figures, it can be seen that the external application does not need 
to know the MQISdp protocol (PUBLISH, PUBREC, PUBREL, PUBCOM commands, 
etc.), all it needs to know are the AT commands described above. 
10 The module makes the interface transparently. Programming of the module to 

make this interface is obvious, firstly from the specifications given above, and secondly 
from the specifications for the MQIsdp protocol. 

Although the present invention has been described with reference to preferred 
embodiments, workers skilled in the art will recognize that changes may be made in 
1 5 form and detail without departing from the spirit and scope of the invention. 



